3D Graphics Programming with QuickDraw 3D 1.5.4
Previous | QD3D Book | Overview | Chapter Contents | Next |
Writing Custom Data
QuickDraw 3D provides a function that you can use to write custom objects. In general, you should call this function only within your custom write method.
Q3View_SubmitWriteData
You can use the Q3View_SubmitWriteData function to submit for writing the data associated with a custom object.
TQ3Status Q3View_SubmitWriteData (
TQ3ViewObject view,
TQ3Size size,
void *data,
void *deleteData);
- view
- A view.
- size
- The number of bytes of data to write. This value should be aligned on 4-byte boundaries.
- data
- A pointer to a buffer of data to be submitted for writing.
- deleteData
- A pointer to a data-deletion method. This method is called after your custom write method exits (whether or not the write method succeeds or fails). The value of the data parameter is passed as a parameter to your method.
DESCRIPTION
The Q3View_SubmitWriteData function submits the data specified by the data and size parameters for writing in the view specified by the view parameter. You can call Q3View_SubmitWriteData in a custom object-traversal method to write the data of a custom object. Q3View_SubmitWriteData calls the write method associated with that custom object type to actually write the data to a file object. When the write method returns, Q3View_SubmitWriteData executes the data-deletion method specified by the deleteData parameter.
SPECIAL CONSIDERATIONS
You should call this function only within a custom object-traversal method. See the chapter "File Objects" for more information about traversal methods.
© 1997 Apple Computer, Inc.
Previous | QD3D Book | Overview | Chapter Contents | Next |